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BASIC TEXT EDITOR 
VERSION 2.0 


GENERAL 

The software contained on the associated North Star diskette is an updated 
version of that which appeared in the article, “BASIC Text Editor", by F.R. 
Ruckdeschel, published in the June 1979 issue of BYTE Magazine. Included on the 
diskette is the original program listed ir that article, along with an updated 
version which incorporates several convenience items which evolved out of 
extensive use of the original version. Also appearing on the diskette is the 
file representing the text presented here (called "COMMENTS" on the diskette), 
as well as the files corresponding to the original version of the above 
mentioned article. The original test editor version is called "EDITOR" and the 
update is called "TEXTED". The comments file is called "COMMENTS" and-.the 
article files are named "FILE<n>'; there ere several sequential files. The 
following discussion is designed to help in understanding and using the TEXTED 
version. Additional notes, more directed et the EDITOR version, appear on the 
disk as a BASIC file called "NOTES". 


BASICS OF OPERATION 

North Star BASIC handles strings in a manner considerably different from other 
BASIC's. A string, say A$, can be any length within the constraint of available 
memory. Such a string may represent an entire document. Another String, say B$, 
may be added to A$ either in front, at the end, or somewnere in between. The 
text editor makes use of this ability by ellowing the user to insert a line of 
any length (even a paragraph or a page) in front of or at the back of the 
existing file. An insertion in the middle of the text can be accomplished in two 
ways. The current file is organized accorcing to numbered (even numbers) lines. 
The user can set the length of these lines at the initialization phase to be 
discussed later. A specified line may be replaced with a line of any length, or 
a line (of any length) may be inserted between two numbered lines. 

To summarize, the text editor is line oriented, and lines may be inserted at 
the beginning or at the end of the current text, between existing lines, or in 
place of an existing line. There are only four places text can be inserted. 


EDITING COMMANDS 
There are few commands to be remembered, but they are powerful. This is in 

contrast to many text editors which have a multitude of commands which are very 
useful to the dedicated user, but confusing to the beginner or occasional 
writer. In fact, many of the complicated systems really do not offer much 
advantage for composing documents such as the one you are presently reading. The 
text editor tends to hold your hand by asking questions. However, two specific 
control characters and their action must te remembered; ampersand and "J". Tf 
the first symbol is flanked on either side Dy a Space (note, there must be two 
Such spaces per ampersand; treat it as a three element control- 
Space/ampersand/space), then when the editor is preparing justified text, a 
carriage return-line feed will occur. This is how you create paragraphs, 
indentations, line skips, and so on. The second symbol ends composition of the 
current line (which, remember, can be almost any length). When you wish to end a 
line insertion (or initial build), a carriage RETURN should be typed. The editor 
Will return with the prompt for continuing to build the line, but instead a "J" 
is typed, followed by a carriage RETURN. The program will then ask further 
questions. : 

Needless to say, one of the most useful editing features is the "delete" 
function automatically available in North Star BASIC. ; 


PARAMETER INITIALIZATION 

To speed up turn-around time in the editing mode, the updated version of the. 
editor uses preset parameters. When the program is first run the user is asked 
whether or not the default parameter values are to be employed. If the answer is 
yes, then unjustified text will be processed (which is convenient for 
composing), line numbering will occur, single spacing used in printing (good for 
CRT editing), and some default line Skip values chosen. If instead the parameter 
values are to be set (such as in printing out the final text), one can do that 
at the initialization phase. The parameter meanings are evident from the 
questions asked by the program. Note that page length refers to the number of 
printed lines; line spacing refers to the number of line skips to be inserted 
between lines (i.e., O means no skips); and justified text refers to printing 
the text out with no breaking of words, with a maximum line length as given ty 
the column width value. 7 


HINTS | 

Read the article included on the diskette. 

Read the NOTES discussion (simply load and run NOTES) 

Always edit a file from the back to the front; editing a particular region 
affects the file structure from that position onwards, but not the structure in 
front of the change. In other words, if two listings are compared, one 
corresponding to the text before the change, and one corresponding to that after 
the change, they would be the same up to the point of alteration. By editing 
from the back to the front, only one hardcopy listing need be made. This is 
useful when both a CRT and hardcopy terminal are available. The hardcopy device 
could be used to generate a full listing, and fast editing could be done using 
the CRT and referencing that listing. 

Always edit in the unjustified mode. It is much faster in terms of prograz 
“execution time. Also, it is more apparent how you are manipulating the text. 

There are only two ways to escape the editing/listing loop. By responding to 
the line number range prompt with a negative number in one of the two positicns, 
the program will jump back to the initialization sequence and ask if a file is 
to be fetched from the disk. The previous page length, skins, spacing, column 
width, line number and justification choices are retained. This is particularly 
useful when preparing the final listings of Many files, such as a large 
manuscript. 

For the sake of orientation, when a line is targeted for editing, the line 
and its two neighbors on either side should be listed as a block. No more than 
this need be listed at any one time if editing is performed from the back of the 
file towards the front. 

Play safe and set "LINE 132" before doing anything. It is very easy to get 
carried away in typing and cause an error by exceeding the maximum allowable 
line length. 

Avoid creating words which are abnormally long as they can detract from the 
appearance of the text in terms of the evenness of the right hand margin. An 
example of such a "word" appeared earlier in the text: space/ampersand/space. It 
caused a very noticeable irregularity in the margin. 

When building a file, assume it will end up much larger than you expect. 
Create a file opening on the disk larger than you think you need, and when the 
program asks for the file length, over-estimate. However, for the sake of 
program execution speed, keep file lengths to 4000 bytes or less.. 

To maintain a sharply defined left margin, follow a period with only one 
Space when ending one sentence and starting another. 


XCI 


KGO 
REA 
MEM 
REA 
LIN 
REA 
LEA 


TEXT EDITOR EXAMPLE 


TEST 10 Create file on disk for storing text 





HASTO4 Release 4 North Star BASIC used for this example 


ny 

SET 49000 | Make sure there is enough memory 

Ny 

te de Forget this and a program crash (due to BASIC) may occur later 
hy 


U TEXTEX Load the text editor 


RES 
RUN 


00 

RAG 
SKI 
SKI 
PAP 
LEi 
CIL: 
Wan 
Wah 
ENT 
GET 


ft 


1 
LIN 


| 
WwW O GIT b W 


DIY 


YOU WANT DEFAULT FORM Y/N)? Default option not chosen 


E LENGTH? ?30 


~ 
J 
jz 
Pome 


PS AT PAGE BOTTOM! 72 
FS AT TOF OF PAGE! ?2 


ER EJECT SKIFS} ?2 

EO FACING: FO 

JMN WETH? PLS Short lines are useful for editing 
TO OLENES NUMBERED (YZN)} PY A must for editing , 
T JUSTIFIED TEXT (Y/N)? ?N | The program runs faster ir this rode “ 
ER FILE LENGTH IN BYTES: ?2000 

FILE FROM DISK? (Y/N)! PN No file exists yet. We wil! build one 
1 x Makes room at the fro-t 








at Inis exgmele is meant to demonstrat @ 

Phow to use the text editor + The iteem. ons some errors can be celeted 

Pto be vedafikay © The whole line was vrong. Used 2 

a covered arel §& & tach "'&'' has its own pair of Spaces 








z 


sal o 


1) The amre rsgrde. & Another error delete- 
4) Tne "at sumbol & Missing ''. Will fix ‘ater 
5). Tne North Sterr. "delete t North Star "delete! ¿sed acain 
4) The pbrecket J g oe Bracket has no effect within line 
J) Insertion at various P laces & 

6) File mame error recovery & 

17I ak End of file buildinc phase 

E NUMBER RANGE! (LOW: HIGH)? 20,40 The "40" was arbitrary 





.-? 
e 





~s 
‘e 
a - -f 


Ds 
3 


2 & This exam . This is the listine upon which 

4 rele is meant to ri the editing is based 

4 enornstrate how to 

8 = use the text edi 

Q tor. The items to 

a be covered are? 

4 & R 1) The 

4 amreersarrnd & 

€ =) The "at sumbol Here is that missing '! 

Q & 3) The No e 

= rth Star “delete" “Note: The program execution speed 
’ & 4) The br is much faster in the non- 
& acket 1 & wt) | Justified mode. File creat- 
8 Insertion at var should be done jn this mode. 
0 ious places & with the justification 

2 46) File name er applied to the final copy. 
4 ror recovery & 


SAME ee ee A a 

CILE LENGTH IS 287 BYTES 

REET SUGROUT DME 

HUNTER LOGE NUMBER TO BE EITED? S64 
INSERTION AT THE END OF THE FILE 





S67 Horefuilw most of the common situstions 


Py 
LINE NUMBER RANGE! (LOW: HIGH)?! P0959 


a & Tis &88 aim 
4 rle is meant to g 
& emanstrate how to 
o Woe bne text edd 
10 tor. Tne items to 
12 me covered arel 
14 & 06 OR Ld The 
1S ameergerd & 

Ee =? The “ab symbol 
20 & 3) The No 
moe rin Star "delete" 
24 & 4) The or 
mS soret J] & Ga 
ms Insertion sat ver 


uy ~ és b eae ty; ` 

3 Lous plagg g 

Aa &) File mame er 
34 ror rocgoyeory & 


AG Hore Pulie most o 
ZE fF Lone cemmorn siti 
A ations will be tr 
42 eated, & & & 


tives Fae’ VP-P 

Paice LENGTH- TE 4 

TNPOT NAME OF FILE? PEST 
RRKWARM TING KK 


MARE SURE DISK DRIVE IS REALTY 
PROGRAM WILL PAUSE WHILE YOU CHECK 
STOF IN LINE 341 

REALY 

CONT 

KUIT SUBROUTINE 

ENTER LINE NUMBER TO BE ENITEN?18 


bee). The “art. tape 
Igrat- Troa "aot" SAPEN a | er ne gi bro L 












i 


: 


34 > File mame error 
3S recovery & Heo 


SAVE PETRE os PN 
FILE LENGTH TS 70 BYTES i 
ERIT SUBROUTINE 
ENTER LINE NUMBER TO BE EMITTED? 36 

36 recovery & He 

SS? recovery & 7) Crash recovers 
r] 
LINE NUMBER RANGES CLOW? HIGH)? POr2 


R 2 This onam 


LENE NUMBER RANGE? (LOWs MIGH)? PIA 3S 


Chose not to save file on dish 


36 is greater than 34, thus we 

go into the appending noae 
Will be tregted. & 4 

50 makes sure the whole text is 

listed 


Observe that the range of the 
listing is under complete control 
of the user. For example, to list 
just line 18, the two input num 
bers could be (18,19). Only the 
line you are interested in need 
be displayed. 


To be safe, save the current text 


~ 
~ 
= 


Be careful here. ''Delete'' is 
legal character in sore cases. 


Errors may not be erassbie. 


This is a prompt on the part of the 
program to be careful. Is the rizht 
disk in place: is the drive on? 


Your response to continue 


Replace line 18 


Inserted that missing ''. Made a nis- 
take in placing symbol. and another 
correcting it. We will see it later 


Individual lines can be displayed 


Want to insert a line, but must 
deal with the text as it exists 
Ho a 


SAVE FILE? (Y/N): PN 
FILE LENGTH IS 419 BYTES 


ENIT SUBROUTINE 

ENTER LINE NUMBER TO BE EQITED?shd 
INFOT ERROR-RETYPE 

P2367 
INSERTION AT 

FORMAT ERROR 

REALY 


QF THE FILE 


399 


THE ENI 
IN LINE 


ORIEN Fis "TEST" 
REALY 

WRITE #1 y At 
READY 

CLOSE AL 

Ri ALY 


DO YOU WANT DEFAULT FORM (YZN)? FPN 
PAGE LENGTHS PO 

SKIFS AT FAGE BOTTOM: P3 

SKIFS AT TOF OF FAGES P3 

FAFER EJECT SKIFS: PAO 

LINE SPACINGS PO 

COLUMN WIUTHS PSS 

WANT LINES NUMBERED (Y/N): PN 

WANT JUSTIFTIEG TEXT (Y/N) PY 
ENTER FILE LENGTH IN BYTES? P2000 
WET FILE FROM DISK? CY/NO0 PY. 
INFUT NAME OF FILE? ?TEST 

LINE NUMBER RANGES CLOWs HIGH): POsT00 


LSRECSCSCCESCCORECE CE CEORS SS. 
This examele i656 meant to demonstrate how to 


text editor. Tne items to be covered are: 
i) The ameersand 
2) The "at" sumool 
3) The North Ster "delete’ 
4) Tne bracket J 
3) Insertion gt various replaces 
6) File mame error recovery 
7) Crasn recovers 


Illegal response as far as the 
program is concerned 
It won't like this 


The program crashed. CONT will not 
work. RUN will initialize everything, 
losing the file. However, there is 
a way to recover the current file.... 


In BASIC, type these commands 


It is very important to note that if BASIC if left and event- 
ually returned to by a "JP 2A04'', 
will be reinitialized. The file in active memory will be lost. 
If you forgot to create a file opening, do so from BASIC only. 


all the variables and strings 


Start up editor again 


We will now list the final draft 


Eject such that there is no printing 
after the text (on the same page) 


We do not want numbers to show 
No splitting of words will occur 


Get the recovered file 


This range should insure a complete 
listing 


use the 


Horefully most of the common situations will be 


treated. 


60 line feeds......... 


Note: To switch from the non-justified to justified mode, a control-C is entered. 
The program is then re-run, and the default option is not chosen. This method 
was decided on after considering approaches which would slow editing, 


SAVE FILEP (Y/N)? ?Y_ Time to save again 

FILE LENGTH IS 398 BYTES 

INFUT NAME OF FILE! ?XxXxXx Made an error in the file name 
KKKWARNIANG KKK 


MAKE SURE DISK DRIVE IS REALY 
PROGRAM WILL FAUSSE WHILE YOU CHECK 


STOF IN LINE 361 To recover from that error, set Z$ 


equal to that string name. Note, as 





ieee we are now in BASIC, some errors 
Se in typing can be immediately 
REALY 
re corrected 
CONT 
EOIT SUBROUTINE 
ENTER LINE NUMBER TO BE ENITED?O Here is a way to get out of edit and 
LINE NUMBER RANGE? (LOW; HIGH)? P250 into listing 
= & This exam 
4 ele ois meant to ad 
4 enanstrate how to As noted in the text, the program 
9 use the text edi execution is fastest in the un- 
10 tor. The items to justified mode. Also, wide lines 
Ta me covered arei are processed faster than narrow 
14 & 2 1) The lines. The example at the left is 
164 amPeersard & considered narrow in width. 
is 2) Tne "et" sum 
29 Qlew--~-sumnbol & Here is that error made earlier while trying to 
oe 3) The North correct another error 
24 Star "delete" & 
od 4) Tne brack. 
nye Ime : 
a ere at eet ee a 
oo) @eiGene.e.  & a NEW PAGE" prompt might have 
34 5 ae a error occurred, In that case the computer 
: oer eee would stop and wait for a "CONT" to 
ae es & be entered from the terminal. The 
3g 7) Crash recovers 


: Moka eas procedure would be to type "CONT", 
19 oe a MORETA advance the paper to the top of a 


ry J ygt P thoe cor : 
ee new page, and then type a carriage 
AS il be treated., % RETURN. 
4E & È 

SAVE FILEP (Y/N)? Fr The program looks for ''Y!! 

FILE LENGTH IS 399 BYTES 

EnIT SUBROUTINE 

ENTER LINE NUMBER TO BE EDITED? 20 
20QL--m- em sumbol & Fix error 

20701 & 

P] 


LINE NUMBER RANGE: (LOW» HIGH)! ?O+4 RichouGh Hoe Snowannees Severino 


the line number range question with 
a negative number in either position 
will cause the program to exit and 
return to the initialization 
sequence starting at the ''GET FILE 

. li 
SAVE FILE? (Y/N): ?N a a then 
FILE LENGTH IS 384 BYTES 


re tained. 
EDIT SUBROUTINE Pe eee 


& This exam 
ele is meant to d 


> to 


ENTER LINE NUMBER TO BE EXITED?L 1 is less than 2, so put text in 
INSERTION AT THE FRONT OF THE FILE front 

1? YOO OOOO IO OOOO OK KOK OOK 
Pl : 


LINE NUMBER RANGE? (LOW» HIGH)? 7460764 It is not going to find these lines 
a as they do not exist 
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Like many an individual who uses com- 
puters at work and for personal purposes, | 
have a tendency to write. At work, this 
tendency is expressed in the usual ways as 
memos, project oriented documentation 
and more general papers. In personal life, 
this tendency is expressed by the existence 
of this article and several others which 
preceded it. 

After some considerable chicken scratch- 
ing it became apparent that my method for 
collecting ideas and creating a final manu- 
script was not optimum. The problem 
became clearly defined when one day | 
looked up from my note pad only to see my 
IMSAI arrogantly sleeping while | worked. 

The literary approach | had been using 
was reasonably conventional. First in the 
procedure was the generation of an outline 
which contained ideas organized by section. 
Then a handwritten rough draft was com- 
posed in which these thoughts were struc- 
tured within each section and expanded 
upon. The draft was then reviewed and 
changes made until legibility was threat- 
ened. If the writing had been for “work” 
the next step would have been to have the 
draft retyped. However, as writing for 
microcomputer journals is a private pursuit, 
a paid typist is used sparingly. 

The next step was therefore to go back 
through the draft and reedit, being very care- 
ful with es and is, and then to give it to the 
typist for final preparation. The typist’s job 
was to take the grubby and somewhat illegi- 
ble pile of paper and transform it into a 
nicely typed manuscript suitable for submis- 
sion. However, the last step was invariably 
one of carefully applying correction fluid, 
scissors and tape in the proper proportions 
to assemble a truly final version. Usually the 


. alterations were due to my own errors, 


though my excellent typist often adds a few 
variations as part of her own editing contri- 
bution. As a result, | have never sent an 
original to an editor, always a copy which 
hid the horrors of the manuscript’s creation. 
After all, what editor wants flakes of dried 
correction fluid sprinkled on his or her 
clothes and desk? 

A few further considerations convinced 
me that it was time to make a change. First, 


I cannot stand reading my own handwriting. 
Second, | can type much faster than I can 
write, Third, it was a convenient time to de- 
sign an editing system. The reason for the 
latter was that | had a video display, IMSAI 
and North Star disk combination at home 
and a very nice Diablo printer, Altair 8800B 
and North Star disk setup available at work. 
Thus there was basic compatibility between 
the two systems via the floppy diskette. | 
had taken care to assure that the two sys- 
tems were software compatible, particularly 
with respect to IO. 

The general idea was to use my personal 
system to compose and edit versions of a 
manuscript and then to bring the finished 
form, on diskette, to work to be printed out 
on the Diablo. In practice it turned out to be 
more convenient to have listings of the vari- 
ous versions to work from. This made 
the iterations much easier. There is no re- 
placement for hard copy when writing either 
a program or an article. 

One of the goals established for the even- 
tual editor software was that it should not 
be unique to my particular hardware con- 
figuration. Rather it was to be translatable 
to other systems with a minimum of change. 
For this reason BASIC was chosen as the 
implementation language, though machine 
language would have led to a much better 
utilization of memory as weli as higher 
speed. The particular BASIC used was North 
Star, Version 6, Release 3. This interpreter 
has string manipulation functions which are 
very convenient for developing editing rou- 
tines. These functions can also be translated 
into counterparts ala Microsoft BASIC. This 
will be discussed more later. 

Text editors naturally require significant 
computer storage capabilities. The one 
shown in listing 1 is no exception. For those 
who have disk based systems other than 
North Star, the conversion of this program 
for use with another system would be 
through changes in the disk access subrou- 
tines which are clearly defined on the listing. 
For those who do not have disk hardware, 
but rather cassette lO, storage and retrieval 
can also be accomplished through the disk 
access subroutines after the appropriate 
modifications are made. : 

The program also has the ability to auto- 
matically save and retrieve the text from 
active memory. This is presently not in ef- 
fect in the version shown in listing 1, but 
can be brought to life by removing state- 
ments 2000 and 2100. This feature is useful 
if the computer is a little unstable and has a 
tendency to crash; at Icast the latest text 
version might be saved in a protected mem- 
ory region if the program did not get as far 
as saving the text on diskette or tape. The 
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Listing 1 continued: 


1890 GOTO 1850 


1900 REM SOF O@seentseececevagseaas 


1910 PRINT “LINE TO BE INSERTED BETWEEN *,2Z 


o" AND *,Z02 


1920 REM F INSERTION WITHIN TEXT 


1930 PRINT $3I,L, 
1940 G$:"" 

1950 B$:"* 

1960 INPUT C$ 


1970 IF G$(1,1)=")" THEN AS=A$(1,E(Z))+BS$AS(E(Z)+1, LEN(AS)) 
1980 IF G$(1,1)=")" THEN GOTO 630 


1990 B$=h$-c$ 
2000 GOTO 1960 


2010 REM Seceeteseccaseresaene 


2020 REM AUTOMATIC RETRIEVAL 
2030 AZEXAM(Y9) +256*EXAM( Y941) 
2040 PRINT "LETTER LENGTH: "A 


2050 RETURN 
2060 ags"™ 


2070 FOR I=1 TO A 


2080 AS=ZA$+CHRS(EXAM({94141)) 


2090 NEXT I 
2100 RETURN 


2110 REM Hosta eenaeeeaaneeees 
2120 Re~ TEMPORARY SAVE 


2130 ASLEN( AS) 


2180 PRINT "LETTER LENGTH: are 


2150 FETURN 


2160 AlzINT( 4/256) 
2170 FILL ¥9,(A-255#a1): 
2180 FILL (¥9+1),A1 


2199 I=1 
2200 I=Ie1 


2210 FILL (¥9+I+1),ASC(A$(I,I)) 
2220 IF I<A THEN GOTO 2200 


2230 RETURN 
READY 


a 
lune 19790) BY EL Puble ations Inc 


are rather elementary and limited, | have 
found them to be sufficient for the need at 
hand. Possible areas for future improvement 
are: 


@ Use of an existing line as the template 
for part of a new line. 

@ Character editing. 

@ A phrase search command. 


The next section will dea! with the actual 
use of the editor, including some of its 
idiosyncrasies. 


Editor Use 


In this section we will briefly discuss 
Operating the program. Listing 2 gives an 
example of how to initiate the building of 
a file. First the disk operating system (DOS) 
is loaded, followed by North Star BASIC, 
Version 6, Release 3. Release 2 will not 
work properly with this particular program 
as there is an error in one of the string 
operations. The next step is to adjust the 
memory domain to be used by BASIC. 
In the diskette form received from North 
Star, only 2.6K bytes are allocated for 
program storage. To load just the editor 
Program 3.9 K bytes are required. Running 
the program requires 7.4K bytes plus as 
much additional memory space as the text 
is long, in characters. In actuality even more 
is used for temporary storage. Thus at this 
point we separate the small memory sys- 
tems from the large. 


The memory size used by BASIC may be 
changed (for North Star, Version 6) by 
placing an appropriate value into hexa- 
decimal location 2A04 (10762 decimal). 
Once this is done, BASIC must be reentered 
so that it learns about this change. Next, 
the editor program is loaded from the 
diskette. In the case of North Star BASIC, 
if a NO PROGRAM error results, it is likely 
that the memory size was not set to a high 
enough value. If a FREE (0) command is 
used to examine the free memory size and 
a FORMAT ERROR occurs, chances are 
that more memory was allocated than was 
available. 

There is freedom to change the maximum 
line length within the editor program. How- 
ever, NO purpose is served if the BASIC being 
used has a line width maximum lower than 
this. Thus it is appropriate to make a line 
width change before proceeding. Also tor 
terminals with slow carriage returns, one 
may exercise the null command. This soft- 
ware delay modification is generally not 
necessary for video displays: the Diablo 
has an internal buffer and the SwTPC PR-40 
works well with a NULL 32. 

The program may now be run. It will ask 
a few simple questions as indicated in 
listing 2. Then it will proceed to a justified 
listing routine which has the dual purpose 
of letting the user see what he or she has 
while also reorganizing the line structure. 
The program then enters the edit mode. In 
the example shown, a simple 2 line text 
is created which includes the new paragraph 
control character. It is important to re- 
member that this control character should 
be surrounded by blanks or it wiil not 
operate properly. The end edit control 
character is also shown. This control is 
functional only when it appears as the first 
character on a line. If one desires to bypass 
the editor entirely, answering the line num- 
ber request with O may be used. | 

There are a few characteristics of the 
editor program which should be observed. 
First, in the justification mode the editor 
avoids breaking apart words by searching 
for blanks to identify word separations. If 
a file does not end with a blank the pro- 
gram will fail. Thus it is good practice to 
end every new line with a blank unless there 
is a compelling reason to do otherwise. This 
is Consistent with most text formats and 
is not limiting. Observe that this restriction 
only applics to the very last character in 
the file. 

Another potential problem area is the 
typing of a line donyer than the length 
allowed by cither the editor itself or the 
Operating system. This leads to a program 


failure. Creating a file longer than allowed 
for on the disk is also not a good thing to 
do. For this reason, before the file is saved 
the text length is printed out as a warning. 


°GO BASIC3 


READY 

FILL 10762,127 

READY 

BYE 

eJP 2a00 

READY 

PRINT FREE(O) 
10812 

READY 

LINE 132 

READY 

LOAD EDITOR6 

READY 

RUN 


ENTER MAXIMUM LINE LENGTH?132 
ENTER LETTER LENGTH? 1000 
INPUT BEGINNING STORAGE LOCATION (DECIMAL): 20 
NEW LETTER (N) OR RESTART (R): ?N ‘ 
GET LETTER FROM FILE? (Y/N): ?N 
13) THIS IS A TEST. & SECOND LINF OF TEST. 
2? . 
COLUMN WIDTH?16 
ENTER PAGE LENGTH: ?20 
WANT LINES NUMBERED? (Y/N): ?Y 
LINE NUMBER RANGF: (LOW, HIGH)?0,10 
WANT JUSTIFIED TEXT? (Y/N): ?Y¥ 


THIS IS -A 
TEST. 


SECOND LINE OF 
TEST. 


On rn 


SAVE LETTER? (Y/N): ?N 
LETTER LENGTH: 46 
EDIT SUBROUTINE 
ENTER LINE NUMBER TO BE EDITTED?6 
6 SECOND LINE OF 
6?) 
COLUMN WIDTH?16 
ENTER PAGE LENGTH: ?20 
WANT LINES NUMBERED? (Y/N): ?Y 
LINE NUMBER RANGE: (LOW, HIGH)?0,10 
WANT JUSTIFIED TEXT? (Y/N): ?Y 


2 THIS IS A 
& TEST. 


6 TEST. 


SAVE LETTER? (Y/N): ?Y 

LETTER LENGTH: 30 

INPUT NAME OF LETTER: ?SAMPLE 
GOOWARNING®S® 


MAKE SURE DISK DRIVE IS READY 
PROGRAM WILL PAUSE WHILE YOU CHECK 
STOP IN LINE 1590 
READY 

CONT 


Listing 2: A sample run of the text editing 
program. Before the program is entered 
there is some initialization that must be per- 
formed. This test shows the two modes of 
operation with line numbers and without 
line numbers. When the program is ready 
to save the edited text it will stop and allow 
you to check that the disk drive is ready for 
operation. The North Star BASIC allows 
further execution of the program after a 
stop statement by entering the command 
CONT. 
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In addition, changing the first character in 
the text is a little cumbersome; it is suggested 
that the very first character be a blank to 
mitigate this problem. 

When any of the above failures occur 
there is a good chance that recently edited 
work may be lost. For example, when a 
program fails, most BASICs enter the direct 
command mode. If the program is rerun, 
most likely the string variables will be 
cleared. ‘The temporary save and retrieval 
subroutines were included to reduce the 
impact of such errors. If the error occurs 
during the edit mode, the last form of the 
text (before the edit mode was entered) 
may be retrieved by rerunning and answer- 
ing the initialization appropriately (re- 
start: R). If the failure occurs during a disk 
or a tape load, unless ‘a large’ crash occurs, 
the most recent text version may be re- 
covered upon restart. 


Additional Notes 


There are several statements employed in 
North Star BASIC which must be modified 
if the editor program is to be used with 
another interpreter. The following is a list 
of the types of changes required if this 
program is to be translated into a BASIC 
similar to that written by Microsoft and 
distributed by MITS: 


FILL<>,<> same as POKE< >< > 
EXAM(< >) same as PEEK(< >) 


% Denotes a printing format (for 
example, nFm which is similar to the 
FORTRAN real format nFm). This can 
be simulated using the INT function 
along with some multiplication and divi- 
sion. In the more advanced versions of 
BASIC there is usually: an equivalent 
_ format statement. 

, Denotes a continued print statement 
without a carriage return and line feed. In 
MITS BASIC one would use a semicolon. 

A$(M,N) With respect to the editing 
functions as implemented by the pro- 
gram, this is the most important differ- 
ence between the North Star and Micro- 
soft interpreters. For the task at hand 
the North Star form is preferred because 
of ease of use. In North Star BASIC 
A$(M,N) represents a substring of A$ 
which runs from character position M to 
character position N, thus having length 
N—M+1. To accomplish this in Microsoft 
BASIC one would use MID$(A$,M, 
N—M+1). Although a little more cumber- 
some, the Microsoft string function 
would suffice if it were not for the 
important variance that North Star 
BASIC allows arbitrarily long string 
lengths whereas Microsoft limits the 


String Icngth to 255 characters. However, 

this limitation may be overcome by 

String subscripts. Note that string dimen- 

sions and subscripts are permitted in 

Microsoft BASIC, but not in North Star. 

Having to resort to subscripts is certainly 

an inconvenience and is a small pain to 

program. North Star BASIC certainly 
has an advantage in that respect. 

The most difficult editing function to 
perform is the alteration of a text segment 
as the set of characters to be changed may’ 
extend over more than one text line. Gen- 
erally it is best to attack the last line of the 
modification first. The corrections should 
then proceed toward the lower line num- 
ber. The reason for doing this is that the 
text is reassembled upon each editing pass. 
If a change is made in a given line, all the 
lines above that point are altered, whereas 
all the lines below that point maintain their 
structure if the same line width format is 
chosen. 

Inserting text is usually easy. As a re- 
dundant word of caution, remember to 
place a blank in the last character position 
in the file. Also, as there is some awkward- 
ness’ in changing the very first character in 
the file, having a blank there is also helpful. 


Conclusion 


The limited capability editor program 
presented in the previous sections has the 
advantages of being easy to use as weil as 
being somewhat portable. It was really 
meant to operate with the North Star Disk 
System, but can be translated for use on 
other BASIC oriented machines. Its utility 
is exemplified by the present article which 
served as a test case. In this application the 
article was broken up into files of 12 blocks 
(12 by 256 characters) or less to ease the 
Strain on active memory. Thus, in effect, 
there is no limit to the document length 
which can be handled. Incidentally, 12 
blocks corresponds to approximately half 
a typeset magazine page, 

The true power of this program is ap- 
parent when large portions of the text 
creation and editing are done on a video 
display system (it is easy to get into the 
swing of rapidly typing additions and 
changes). However, occasional hard copy 
listings are invaluable for leisurely review- 
ing. A near ideal combination would seem 
to be a video display for editing and a fast 
hard copy terminal for printing. The denser 
and faster the video display the better.# 


Copies of the software shown on listing 1 
are available from the author on diskettes in 


North Star format for $9.95 each (New York 
State residents add sales tax). 





